home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 176-200 / scopedisk188 / backtalk / changes < prev    next >
Text File  |  1995-03-19  |  10KB  |  262 lines
  1.  
  2. Added in 1.20
  3. ---------------
  4.  
  5. Added ability to call ARexx scripts from within BackTalk.  When BackTalk
  6.    is run, if the port "REXX" is found, a new menu named ARexx is added.
  7.    The only menuitem under ARexx is "Run ARexx Script...".  When that menu
  8.    item is selected a file requester is presented that is defaulted to
  9.    REXX: and the file names defaulted to #?.BT.  For BackTalk to automatically
  10.    recognize ARexx scripts written specifically to be run from within BackTalk,
  11.    name your scripts with the ".BT" extension.
  12.  
  13. Added the ability to run ARexx scripts from an FKey.  In your macro definition,
  14.    the backslash (\) is used as a delimiter.  If you need to actually send a
  15.    backslash in a macro preceed it with another backslash (ie, \\).  The text
  16.    inside the backslash delimited string is the name of the ARexx script.  There
  17.    is no need to enter the complete path for the ARexx script nor the extension.
  18.    REXX: is assumed for the path and .BT is assumed for the extension.
  19.  
  20. Added the ARexx commands ...
  21.  
  22. CLEARSCREEN  Usage: CLEARSCREEN
  23.    This will clear the communications window (full screen if no chat window,
  24.    or up to chat bar if chat window is present).
  25.  
  26. FONT  Usage: FONT <fontname> <size>  (ie, FONT "courier" "13")
  27.    Will load in a new font.  If the point size argument is missing
  28.    no change will be made and an error of "5" will be returned.  If
  29.    the font name cannot be found the font will be changed to Topaz 8 and
  30.    and error of 10 will be returned.
  31.  
  32. GETSTRING  Usage: GETSTRING <no argument> | <string>
  33.    Brings up a string requester and returns the string to ARexx.
  34.    The argument for this command is the prompt string for the requester.
  35.    You may remember why the requester popped up requesting input but
  36.    other users of your script might not.  If no argument is given the
  37.    default text is "Enter your text".  An error code of 10 is returned
  38.    if the requester failed to display.
  39.  
  40. GETFILENAME  Usage: GETFILENAME
  41.    Brings up a file requester and returns the full path to ARexx.
  42.  
  43. PROTOCOL  Usage: PROTOCOL <xprlibrary name>  (ie., PROTOCOL "xprascii")
  44.    Selects and loads the specified XPR library.  The ".library" is not 
  45.    needed in the argument (but nothing is harmed if it's there).  If the 
  46.    specified library cannot be loaded for some reason, the xprquickb.library
  47.    will be loaded.  If this is the case an error of 10 will be returned,
  48.    otherwise the result will be 0.
  49.  
  50. DOWNLOAD  Usage: DOWNLOAD <path/filename>
  51.    The argument the path/name of the file that is written to your computer.
  52.    If no path/filename argument is given a file requester will be presented
  53.    for you to enter the path/name.  If you select Cancel on the file requester
  54.    or select USE with no filename selected a non-zero error code will be
  55.    returned.
  56.  
  57. UPLOAD  Usage: UPLOAD <path/filename>
  58.    The argument the path/name of the file that is sent from your computer.
  59.    If no path/filename argument is given a file requester will be presented
  60.    for you to enter the path/name.  If you select Cancel on the file requester
  61.    or select USE with no filename selected a non-zero error code will be
  62.    returned.
  63.    
  64. DOTS  Usage: DOTS
  65.    This is a toggle.  If the "Append ..." feature is set, this turns it off.
  66.    If it's not set, this turns it on.
  67.  
  68. BORDER  Usage: BORDER
  69.    This is a toggle.  If the window border is displayed, this turns them off.
  70.    If they're off, this turns them on. 
  71.  
  72. CHAT  Usage: CHAT
  73.    This is a toggle.  If the chat window is up, this removes it.  If it is
  74.    not enabled this enables it.
  75.  
  76. CLICK  Usage: CLICK
  77.    This is a toggle.  If the "Double Click XON/XOFF" feature is set this
  78.    turns it off.  If it is off, this turns it on.
  79.  
  80. SENDU  Usage: SENDU
  81.    This is a toggle.  If the "Preface lines from chat window with ^U" is set
  82.    this turns it off.  If it is off, this turns it on.
  83.  
  84. SPLIT  Usage: SPLIT
  85.    This is a toggle.  If you are running on an interlaced system, SPLIT will
  86.    toggle from full screen display to half screen display and back again.
  87.  
  88. BITPLANE1  Usage: BITPLANE1
  89.    Causes BackTalk to be run in a 1 bitplane custom screen.
  90.  
  91. BITPLANE2  Usage: BITPLANE2
  92.    Causes BackTalk to be run in a 2 bitplane custom screen.
  93.  
  94. WBWINDOW  Usage: WBWINDOW
  95.    Causes BackTalk to be run in a Workbench window.
  96.  
  97. ONSTRING  Usage: ONSTRING <string>
  98.    Sends a message to ARexx whenever <string> is encountered in the
  99.    serial input stream.  Your ARexx program must open a port named
  100.    BT_msg.  When a match is found, BackTalk will send a message
  101.    to BT_msg, arg0 will be MATCH.
  102.  
  103.    You may embed control characters within <string>.  To do so, use 
  104.    the ^ (caret) then the character.  (ie, "John^M^J(" will cause the
  105.    serial input stream to be searched for "John" followed by an
  106.    0x0d (^M/carriage return), a 0x0a (^J), and a left parenthesis.
  107.    If you want to search the input stream for a ^ (caret) itself,
  108.    use "^^".  IE., to search for "2^2" your string would be entered
  109.    as "2^^2".  Each caret to be searched for must be preceeded with
  110.    another caret so the program knows you really want to search for
  111.    a caret and not to interpret it as the next character being a
  112.    control character.
  113.  
  114.    NOTE:  If you call ONSTRING while an existing ONSTRING command is
  115.           running you will not add a second string to search for but
  116.           will change the search string for the currently running
  117.           iteration of ONSTRING.
  118.           IE., ONSTRING "JOE"   (input stream being searched for "JOE")
  119.                ONSTRING "MOE"   (input strean now being searched for "MOE")
  120.  
  121. OFFSTRING  Usage: OFFSTRING <no argument> | <string>
  122.    This causes BackTalk to terminate the ONSTRING command.
  123.    If an argument is given to OFFSTRING it will be searched for in the
  124.    serial input string.  When found BackTalk will send a message to 
  125.    ARexx which will terminate the ONSTRING command.  If no argument
  126.    is given to OFFSTRING a message will be sent to ARexx immediately
  127.    to terminate the ONSTRING command.
  128.  
  129.    When the message is sent to ARexx it is sent to a port that ARexx
  130.    has opened named "BT_msg".  Arg0 will contain "OFF".
  131.  
  132.    You may embed control characters within <string>.  To do so, use 
  133.    the ^ (caret) then the character.  (ie, "John^M^J(" will cause the
  134.    serial input stream to be searched for "John" followed by an
  135.    0x0d (^M/carriage return), a 0x0a (^J), and a left parenthesis.
  136.    If you want to search the input stream for a ^ (caret) itself,
  137.    use "^^".  IE., to search for "2^2" your string would be entered
  138.    as "2^^2".  Each caret to be searched for must be preceeded with
  139.    another caret so the program knows you really want to search for
  140.    a caret and not to interpret it as the next character being a
  141.    control character.
  142.  
  143.    NOTE:  If you call OFFSTRING with an argument while OFFSTRING (with
  144.           an argument) was previously called, you will not be adding
  145.           an additional terminate string to search for but will be changing
  146.           the existing terminate string.
  147.  
  148. QSCREEN  Usage QSCREEN
  149.    Returns the string "SCREEN" or "WORKBENCH" indicating in what screen mode
  150.    the program is currently running.
  151.  
  152. QSIZE  Usage: QSIZE
  153.    Checks whether the program is running with a half or full sized window.
  154.    Returns the string "HALF" or "FULL".
  155.  
  156. QLACE  Usage: QLACE
  157.    Checks the interlace flag.  Returns the string "ON" or "OFF".
  158.  
  159. QDEPTH  Usage: QDEPTH
  160.    If the program is running on a custom screen, returns, as a string,  the
  161.    number of bit planes.  If running in a workbench window, it returns a
  162.    null string.
  163.  
  164. QFONTNAME  Usage: QFONTNAME
  165.     Returns the name of the currently selected font.
  166.  
  167. QFONTSIZE  Usage: QFONTSIZE
  168.    Returns the size of the currently selected font.
  169.  
  170. QCHAT  Usage: QCHAT
  171.    Returns the "ON" or "OFF" state of chat window.
  172.  
  173. QBORDER  Usage: QBORDER 
  174.    Returns the "ON" or "OFF" state of the window borders.
  175.  
  176. QDUPLEX  Usage: QDUPLEX
  177.    Returns the "FULL" or "HALF" state of the duplex.
  178.  
  179. QBAUD  Usage: QBAUD
  180.    Returns the current baud rate.
  181.  
  182. QWLENGTH  Usage: QWLENGTH
  183.    Returns the current word length setting.
  184.  
  185. QSTOPBITS  Usage: QSTOPBITS
  186.    Returns the current stop bit setting.
  187.  
  188. QPARITY  Usage: QPARITY
  189.    Returns the current parity setting, "NONE", "ODD", or "EVEN".
  190.  
  191. QDEVICENAME  Usage: QDEVICENAME
  192.    Returns the name of the currently seleced serial device.
  193.  
  194. QUNITNUMBER  Usage: QUNITNUMBER
  195.    Returns the currently selected serial device unit number.
  196.  
  197. QPROTOCOL  Usage: QPROTOCOL
  198.    Returns the currently selected XPR protocol.
  199.  
  200. QDOTS   Usage: QDOTS
  201.    Returns the state of "Append ...".  "ON" or "OFF".
  202.  
  203. QPIXELS  Usage: QPIXELS
  204.    Returns the currently selected pixel length wrap point.
  205.  
  206. QCAPTURE  Usage: QCAPTURE
  207.    Returns the name of the default capture path/file
  208.  
  209. QDOWNLOAD  Usage: QDOWNLOAD
  210.    Returns the name of the default download path
  211.  
  212. QUPLOAD  Usage: QUPLOAD
  213.    Returns the name of the default upload path
  214.  
  215. QCLICK  Usage: QCLICK
  216.    Returns the current state of the "Double Click XON/XOFF" feature, 
  217.    "ON", or "OFF".
  218.  
  219. QSENDU  Usage: QSENDU
  220.    Returns the current state of the "prepend ^U to chat lines" feature, 
  221.    "ON", of "OFF"
  222.                
  223. QSADDRESS  Usage: QSADDRESS
  224.    If BackTalk is currently running in a custom screen, this
  225.    returns the hex address of that screen.  If the program is
  226.    running in a workbench window, this command returns a null string.
  227.  
  228.  
  229. Changes in 1.20
  230. ---------------
  231.  
  232. SEND  Usage: SEND <string>
  233.    Sends a string to the serial port with a terminating carriage return.
  234.    If the first character of <string> is a ^ (caret) the following
  235.    character will immediately be sent as a control character and any
  236.    text following that 2 character sequence will be ignored.  No carriage
  237.    return is sent after a control character regardless of whether SEND
  238.    or SENDNCR was used.
  239.  
  240.  
  241. Fixes in 1.20
  242. -------------
  243.  
  244. Fixed a "one off" problem in screen clearing when a Form Feed is received and
  245. and the chat window is on.
  246.  
  247. Fixed problems with check marks not being displayed properly in the 
  248. Configuration submenus.
  249.  
  250. If an incoming line ends with a LF instead of the CR/LF combo, text
  251. will be displayed properly.
  252.  
  253. Misc in 1.20
  254. ------------
  255.  
  256. This is not new and not fixed but was not doc'ed before - an additional 
  257.    ARexx command...
  258.  
  259. LMACROS  Usage LMACROS <path/filename>
  260.    This will load in an alternate set of macros.
  261.    returns a non-zero on failure.
  262.